Pull Request概要が仕様書になる
PullRequestの説明をなんども書き直す - Nota社のScrapboxを一部公開
pull request概要とコメントは
証拠保全・責任追及のための道具ではない
pull requestそのものをrevertする意思決定のためのドキュメントである
revert・修正は忙しい状況で行われる
bugが発生した時の問題切り分け
新機能追加で機能同士の衝突が起きた時
だから初見の人が読んで理解できるドキュメントとして、概要欄はメンテナンスしなければならない